// Copyright  2004-2008 Backplane Ltd.
//
// This file is part of Ubiquity formsPlayer
//
// Ubiquity formsPlayer is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the
// Free Software Foundation; either version 3 of the License, or (at your
// option) any later version.
//
// Ubiquity formsPlayer is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
// more details.
//
// You should have received a copy of the GNU General Public License
// along with Ubiquity formsPlayer If not, see <http://www.gnu.org/licenses/>.
//	
//
//   Purpose: declaration of getContainedObject.
//   $Id$


#pragma once
	/*
	<summary>
		When working with an <object> html object, we will normally want to be
		working with the object that is contained within that object tag.
		rather than the htmlobject.

		This function pulls the object out of the IHTMLObject.
	</summary>
	<param name="pOuterObject">The object element.</param>
	<param name="id">The IID of the interface you want returned.</param>
	<param name="pvInnerObject">pointer to the returned interface</param>
	<returns>
	E_FAIL if pOuterObject was not an object element.<br />
	E_NOINTERFACE if the contained object does not support the interface specified by id.
	</returns>
	*/

HRESULT getContainedObject(IUnknown * pOuterObject, const _GUID  id,void** pvInnerObject);
